Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Universal Imaging Messages

GXImageDocument

QuickDraw GX sends the GXImageDocument message just prior to starting the imaging of a document. You need to override the GXImageDocument message if you want to perform a task at the start of imaging for a document. Your override of the GXImageDocument message must match the following formal declaration:

OSErr MyImageDocument (gxSpoolFile aSpoolFile, void *imageData);

aSpoolFile

The spool file to image.

imageData

A pointer to imaging-system-specific data.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXImageDocument message to print a spool file.

The default implementation of the GXImageDocument message prints the document. First, it creates a new format to use when it calls the GXDespoolPage message. Then it sends the GXCountPages message to find out how many pages are on a spool file. It loops, sending the GXImagePage message for each page in the document. And finally, it disposes of the format that it allocated.

SPECIAL CONSIDERATIONS

You never send the GXImageDocument message yourself.

You almost always forward the GXImageDocument message to other message handlers. You can forward the message before or after performing your own tasks.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The GXDespoolPage message is described on page 4-75.

The GXCountPages message is described on page 4-74.

The GXImagePage message is described on page 4-94.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help